<div id="Builds"></div>
<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">|[[cvs: Tracking third-party sources#Tracking third-party sources| &lt;&lt; ]]|</td>
<td valign="middle" align="left">|[[cvs: Tracking third-party sources#Multiple vendor branches| &lt; ]]|</td>
<td valign="middle" align="left">|[[cvs#Top| Up ]]|</td>
<td valign="middle" align="left">|[[cvs: Special Files#Special Files| &gt; ]]|</td>
<td valign="middle" align="left">|[[cvs: Special Files#Special Files| &gt;&gt; ]]|</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">|[[cvs#Top|Top]]|</td>
<td valign="middle" align="left">|[[cvs: Table of Contents#SEC_Contents|Contents]]|</td>
<td valign="middle" align="left">|[[cvs: Index#Index|Index]]|</td>
<td valign="middle" align="left">|[[cvs: About this Manual#SEC_About| ? ]]|</td>
</tr></table>
<div id="How-your-build-system-interacts-with-CVS"></div>
== How your build system interacts with CVS ==
<div id="index-Builds"></div>
<div id="index-make"></div>

As mentioned in the introduction, <small>CVS</small> does not
contain software for building your software from source
code.  This section describes how various aspects of
your build system might interact with <small>CVS</small>.

One common question, especially from people who are
accustomed to <small>RCS</small>, is how to make their build get
an up to date copy of the sources.  The answer to this
with <small>CVS</small> is two-fold.  First of all, since
<small>CVS</small> itself can recurse through directories, there
is no need to modify your &lsquo;<tt>Makefile</tt>&rsquo; (or whatever
configuration file your build tool uses) to make sure
each file is up to date.  Instead, just use two
commands, first <code>cvs -q update</code> and then
<code>make</code> or whatever the command is to invoke your
build tool.  Secondly, you do not necessarily
''want'' to get a copy of a change someone else made
until you have finished your own work.  One suggested
approach is to first update your sources, then
implement, build and
test the change you were thinking of, and then commit
your sources (updating first if necessary).  By
periodically (in between changes, using the approach
just described) updating your entire tree, you ensure
that your sources are sufficiently up to date.

<div id="index-Bill-of-materials"></div>
One common need is to record which versions of which
source files went into a particular build.  This kind
of functionality is sometimes called <em>bill of
materials</em> or something similar.  The best way to do
this with <small>CVS</small> is to use the <code>tag</code> command to
record which versions went into a given build
(see section [[cvs: Revisions#Tags&ndash;Symbolic revisions|Tags&ndash;Symbolic revisions]]).

Using <small>CVS</small> in the most straightforward manner
possible, each developer will have a copy of the entire
source tree which is used in a particular build.  If
the source tree is small, or if developers are
geographically dispersed, this is the preferred
solution.  In fact one approach for larger projects is
to break a project down into smaller
separately-compiled subsystems, and arrange a way of
releasing them internally so that each developer need
check out only those subsystems which they are
actively working on.

Another approach is to set up a structure which allows
developers to have their own copies of some files, and
for other files to access source files from a central
location.  Many people have come up with some such a
system using features such as the symbolic link feature
found in many operating systems, or the <code>VPATH</code>
feature found in many versions of <code>make</code>.  One build
tool which is designed to help with this kind of thing
is Odin (see
<code>ftp://ftp.cs.colorado.edu/pub/distribs/odin</code>).


----

<table class="header" cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">|[[cvs: Tracking third-party sources#Tracking third-party sources| &lt;&lt; ]]|</td>
<td valign="middle" align="left">|[[cvs: Special Files#Special Files| &gt;&gt; ]]|</td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left"> &nbsp; </td>
<td valign="middle" align="left">|[[cvs#Top|Top]]|</td>
<td valign="middle" align="left">|[[cvs: Table of Contents#SEC_Contents|Contents]]|</td>
<td valign="middle" align="left">|[[cvs: Index#Index|Index]]|</td>
<td valign="middle" align="left">|[[cvs: About this Manual#SEC_About| ? ]]|</td>
</tr></table>
This document was generated on <i>a sunny day</i> using [http://www.nongnu.org/texi2html/ <i>texi2html</i>].
